---
title: Options héritées
i18nReady: true
---

Pour aider certains utilisateurs à migrer entre les versions d'Astro, nous introduisons occasionnellement des options héritées (ou `legacy` en anglais).

Ces options vous permettent d'accepter certains comportements dépréciés ou obsolètes d'Astro dans la dernière version, afin que vous puissiez continuer à mettre à niveau et profiter des nouvelles versions d'Astro jusqu'à ce que vous soyez en mesure de mettre à jour complètement le code de votre projet.

import Since from '~/components/Since.astro'

## Collections

<p>

**Type :** `boolean`<br />
**Par défaut :** `false`<br />
<Since v="5.0.0" />
</p>

Activer le comportement hérité pour les collections de contenu (tel qu'utilisé dans Astro v2 à v4)

```js
// astro.config.mjs
import { defineConfig } from 'astro/config';
export default defineConfig({
  legacy: {
    collections: true
  }
});
```

Si cette option est activée, les collections de données et de contenus (uniquement) sont gérées à l'aide de l'implémentation des collections de contenu héritées. Les collections avec un `loader` (uniquement) continueront à utiliser l'API de la couche de contenu à la place. Les deux types de collections peuvent exister dans le même projet, chacune utilisant leurs implémentations respectives.
 
Les limitations suivantes subsistent :

- Toutes les collections héritées (`type: 'content'` ou `type: 'data'`) doivent continuer à être situées dans le répertoire `src/content/`.
- Ces collections héritées ne seront pas transformées pour utiliser implicitement le chargeur `glob()` et seront plutôt gérées par le code hérité.
- Les collections utilisant l'API de la couche de contenu (avec un `loader` défini) sont interdites dans `src/content/`, mais peuvent exister n'importe où ailleurs dans votre projet.

Lorsque vous êtes prêt à supprimer cette option et à migrer vers la nouvelle API de la couche de contenu pour vos collections héritées, vous devez définir une collection pour tous les répertoires de `src/content/` que vous souhaitez continuer à utiliser comme collection. Il suffit de déclarer une collection vide et Astro générera implicitement une définition appropriée pour vos collections héritées :
 
```js
// src/content/config.ts
import { defineCollection, z } from 'astro:content';

const blog = defineCollection({ })
 
export const collections = { blog };
```
